CosyOS_用户API

用户通过调用API来实现对系统服务的调用，所有API均为宏定义， 所有系统服务也为宏定义，所有API参数均支持宏定义。 更多...

CosyOS_用户API 的协作图:

模块
	任务
	创建钩子
	定时中断_查询
	信号量
	私信
	私信是CosyOS独创的一种任务间通信方式，典型特征是 随意定义、灵活多变。
	飞信
	飞信是轻量型的、超高速的线程通信工具，典型特征是 极简类型、极速通信。
	邮箱
	消息队列
	消息队列是唯一能够实现并发消息同步的手段。
	事件标志组
	全局变量访问
	软件RTC
	动态内存
	临界区
	杂项

详细描述

用户通过调用API来实现对系统服务的调用，所有API均为宏定义， 所有系统服务也为宏定义，所有API参数均支持宏定义。

• API分类

• 创建API
  静态创建：前缀为“u”，分为声明对象（uExtern）、创建对象（uCreate）、定义对象（uDef）。
  动态创建：前缀为“d”，分为声明对象（dExtern）、创建对象（dCreate）。

• 任务API
  前缀为“u”，指仅在任务中调用。

• 滴答API
  前缀为“t”，指仅在系统滴答中断中调用，包括在滴答钩子、定时中断钩子、
  定时查询钩子、定时查询事件等处调用。

• 中断API
  前缀为“i”，指仅在用户中断中调用。

• PSVAPI
  前缀为“p”，指仅在 pendsv_hook 中调用。

• 公共API
  前缀为“x”，指可在任意处（任务、滴答、中断）调用。

• API返回

• 无返回
  （1）服务的执行结果一定是成功的，所以不需要返回。
  （2）所有中断挂起服务均无返回。

• 返回错误码
  服务的执行结果可能会失败，导致失败的原因可能有多个。
  （1）绿码：无错误。
  （2）黄码：由于结果已经成功，导致本次并未执行。
  （3）红码：失败。

• 返回结果
  服务的执行结果可能会失败，但导致失败的原因是唯一的。
  执行结果为 bool 类型，true 为成功，false 为失败。

• 返回指针
  返回一个指针，(void *) 类型，NULL 为失败。

• 返回值
  返回一个数值，特定的数据类型，0 为失败。